home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / kickstart tools / mkick / readme < prev    next >
Text File  |  1996-04-07  |  9KB  |  225 lines
  1. ==============================================================================
  2.  
  3.                          MJSoft's Kicker -- MKick 1.8
  4.  
  5.               (c) 1992-1995 Martin Mares, MJSoft System Software
  6.  
  7. ==============================================================================
  8.  
  9.  
  10. What is MKick
  11. -------------
  12.  
  13.    MKick is a replacement of KickIt, ZKick, LKick and Rekick kickers for use on
  14. machines with kickstart 1.2 or 1.3 in ROM (It also tries to be as powerful as
  15. SinSoft's SKick).
  16.  
  17.    The main advantages of MKick are:
  18.  
  19.  - ability to relocate any Kickstart to CHIP, FAST (C0-RAM), NON-AUTOCONFIG
  20.    RAM or EXPANSION RAM if a relocation table is supplied.
  21.  
  22.  - standard operation (like ZKick) if the relocation table is not available.
  23.  
  24.  - reading of both KickIt and ROM Image Kickstart formats (encrypted
  25.    beta-ROMs for A600 must be converted by MakeKick)
  26.  
  27.  - patch function using supplied patch table (may correct known Kickstart bugs).
  28.  
  29.  - can be started from both the command line and the Workbench.
  30.  
  31.  - Graphic User Interface (GUI).
  32.  
  33.  - Small code size, because it's written completely in assembly.
  34.  
  35.  - loaded Kickstart survives user reset and crashes (when the ExecBase is not
  36.    destroyed).
  37.  
  38.  - C0-RAM salvage: many Kickstarts perform destructive tests of C0-RAM (FAST
  39.    RAM). MKick stores critical bytes in its own storage and restores their
  40.    contents after memory tests.
  41.  
  42.  - If you have Kickstart 39.106 or higher, the alert timing constant
  43.    (execbase+$20E) won't be lost during reboot.
  44.  
  45.  - Non-autoconfig can be added automatically without using special resident
  46.    utilities.
  47.  
  48.  - ROM Kickstart can be relocated to RAM. This speeds up system operation on
  49.    the most of accelerated systems (e.g. GVP A530 Turbo). In this case, you
  50.    needn't the Kickstart image file, MKick will load it directly from your ROM.
  51.  
  52.  - Waits for all disks to be validated before performing any operation.
  53.  
  54.  - New memlist named Kickstart is created if the KS image is not stored in
  55.    one of original memlists. This prevents MonAm from treating KS image
  56.    as out-of-memory space.
  57.  
  58.  - Ability to get rid of resident modules by simply pressing the left mouse
  59.    button at correct time (see below).
  60.  
  61.  - ExecBase can be moved to expansion or non-autoconfig fast memory, which
  62.    slightly increases system speed. (In such case, it is sometimes not possible
  63.    to survive reboots -- see discussion in MKick.doc.)
  64.  
  65.  - CPU vectors can be relocated to fast memory, which increases system
  66.    performance (only possible on 68010+).
  67.  
  68.  
  69. Copyright
  70. ---------
  71.  
  72.    MKick and all the utilities in this package, including their documentation,
  73. with the exception of KickStat are Copyright (C) 1995 Martin Mares, Prague,
  74. Czech Republic.
  75.  
  76.    The  KickStat  utility  is  Copyright  (C) 1995 SinSoft and is included with
  77. permission of its author.
  78.  
  79.    This  archive  can  be  freely  redistributed as long as all of its files are
  80. included   in   their   original   form  without  any  additions,  deletions  or
  81. modifications  (excluding addition of other README-style files and icons) and no
  82. more  than a nominal fee is charged for its distribution.  All copyright notices
  83. in  the  programs and accompanying documentation files must remain intact.  It's
  84. especially  forbidden  to add various '.displayme' files and BBS advertisements.
  85. This style of distribution is generally known as FREEWARE.
  86.  
  87.    There's one exception to these rules -- the author allows all the utilities
  88. to be included in SKick archives.
  89.  
  90.    This package is provided as is, any warranties cannot be applied.  Any
  91. usage of this program or other parts of this archive will be done at your own
  92. risk!
  93.  
  94.  
  95. Contents
  96. --------
  97.  
  98.    README             - this file
  99.    README.BUGREPORTS  - how to write MKick bug reports
  100.    README.3.1         - additional information concerning 3.1 Kickstarts
  101.    HISTORY            - history of development
  102.  
  103.    MKick              - the kicker itself
  104.    MKick.info         - icon
  105.  
  106.    MakeKick           - utility for creation of Kickstart header files
  107.    Kick2RTB           - converts Kickstart header files to SKick format
  108.    MakeKickDisk       - makes special boot disk for fast booting of Kickstarts
  109.    SwitchScript       - utility for easy switching of startup scripts
  110.    SumKick            - calculates checksum of Kickstart image
  111.    KickStat           - shows information about currently running Kickstart
  112.    KickInfo           - utility showing information about Kickstart file
  113.    FastEBPatch        - set of patches for operation with ExecBase in exp. RAM
  114.    AddModule          - utility for easy addition of resident modules
  115.  
  116.    *.doc              - Documentation
  117.  
  118.    KSHD/*.kick        - Kickstart headers for various Kickstarts
  119.    KSHD/*.kshd        - source files for Kickstart headers
  120.  
  121.    Delta/*            - delta files to recover patched Kickstarts
  122.                         (see delta/README for more info)
  123.  
  124.  
  125. Included Kickstart headers
  126. --------------------------
  127.  
  128.    The  Kickstart  header  files containing the relocation table and information
  129. needed  to load the Kickstart are supplied for following Kickstarts:
  130.  
  131.    Kick33180.A500            standard 1.2 for A500/A2000
  132.    Kick34005.A500            standard 1.3 for A500/A2000
  133.    Kick37175.A500            standard 2.04 for A500+
  134.    Kick39046.A500.BETA       beta-version of 3.0
  135.    Kick39106.A1200           standard 3.0 for A1200
  136.    Kick39110.A500.BETA       beta-version of 3.0
  137.    Kick39115.A3000.BETA      beta-version of 3.0
  138.    Kick39115.A3000SK.BETA    beta-version of 3.0, SuperKickstart file
  139.    Kick40003.A3000.BETA      beta-version of 3.0, SuperKickstart file
  140.    Kick40038.A600.BETA       beta-version of 3.1
  141.    Kick40063.A600            3.1 ROM for A600
  142.    Kick40068.A600            3.1 Rekick file for A600
  143.    Kick40068.A1200           3.1 ROM for A1200 (requires 68020+)
  144.    Kick40068.A4000           3.1 ROM for A4000 (requires 68020+)
  145.    Kick40070.A600            3.1 Rekick file for A600
  146.    Kick40070.A3000           3.1 SuperKickstart for A3000 (requires 68020+881)
  147.    Kick40070.A4000           3.1 ROM for A4000 (requires 68020+)
  148.    Kick40070.A4000T          3.1 ROM for A4000T (requires 68020+)
  149.  
  150.    For 3.1 Kickstarts, see notes in README.3.1.
  151.  
  152.    If you have a Kickstart which is not included in this list, try to download
  153. latest version of SKick if it contains RTB and PAT files for your Kickstart
  154. and convert them by the MakeKick utility (AUTO option).
  155.  
  156.  
  157. System requirements:
  158. --------------------
  159.  
  160.   - Amiga 500, 1000 or 2000
  161.  
  162.   - Minimally 1 meg of RAM (all possible combinations)
  163.  
  164.   - Kickstart 1.2 or 1.3 in ROM
  165.  
  166.   - arp.library in the LIBS: directory
  167.  
  168.  
  169. Installation:
  170. -------------
  171.  
  172.    (1) Create DEVS:Kickstarts and copy all your Kickstart images to it. This
  173.        directory is searched automatically in the GUI mode (can be overriden
  174.        by the KICKDIR option if you want).
  175.  
  176.    (2) Find proper Kickstart header files (you may find a list of them above).
  177.        Rename Kickstart files to match the names of the header files -- for
  178.        kick39115.A3000.BETA.kshd, the Kickstart image should be renamed to
  179.        kick39115.A3000.BETA. (It's also possible to rename the header files
  180.        according to names of Kickstart images, but it's a bit confusing.)
  181.  
  182.        THERE ARE NO KICKSTART IMAGES IN THIS ARCHIVE
  183.  
  184.        If you don't know the exact name of .kick file to be used, consult the
  185.        KickInfo utility (see its doc for how to do it).
  186.  
  187.    (3) Copy the executable files to some place, preferably to some that is
  188.        included in PATH. It's better to copy the MKick executable itself to
  189.        C: to allow using it before any paths are set.
  190.  
  191.    (4) If you want MKick to work automatically, insert it as a FIRST line of
  192.        your Startup-sequence. It allows MKick to handle all operations requiring
  193.        system reboot (switching from one Kickstart in RAM to another one etc.)
  194.        without user intervention.  When you hold down the left mouse button
  195.        during system reboot, the GUI screen will appear.
  196.  
  197.    (5) If you want your startup scripts to be switched according to Kickstart
  198.        version, install the SwitchScript utility (see its .doc for how to do it)
  199.  
  200.  
  201. Thanks:
  202. -------
  203.  
  204.  - to Commodore-Amiga for the Operating System.
  205.  
  206.  - to SinSoft for his SKick and a lot of good ideas.
  207.  
  208.  - to Tomas Zikmund, Petr Cisar and Stefan Stuntz for beta-testing.
  209.  
  210.  - to many people for sending me their bug reports
  211.  
  212.  
  213. Final words:
  214. ------------
  215.  
  216.    Known bugs: MKick probably doesn't work with 68040 CPU, because I have no
  217.                beta-testers with such machine and I have no documentation for
  218.                this CPU.
  219.  
  220.    Send bug reports and comments to mj@k332.feld.cvut.cz
  221.     (Before sending bug reports, you should read the README.BUGREPORTS file).
  222.  
  223.    Excuse me for my bad English and all bugs.
  224.  
  225.